---
title: "SQL-VP-004: Retrieve affiliated-policy list for a policy"
summary: Retrieves the affiliated-policy list for a policy via the Oracle view-policy package.
status: draft
owner: SAIF Claims BOF team
last_reviewed: 2026-08-21
library: SAIF.Business.View.Policy
reference_type: embedded
---

# SQL-VP-004 Retrieve affiliated-policy list for a policy

Retrieves the set of policies affiliated with a given policy, populating
`clsAffiliatedPolicyCollection`. The returned rows are filtered in-memory in `AfterRetrieve` by
agent number/agency sequence number (see [BR-VP-013](../business-rules.md#br-vp-013-affiliated-policy-agent-agency-filter)).

## Classification

| Field | Value |
| --- | --- |
| **SQL ID** | SQL-VP-004 |
| **Operation type** | Read |
| **Execution method** | Stored procedure |
| **Database** | Oracle |
| **Schema** | `[unqualified]**` |
| **Command type** | StoredProcedure |
| **Business object** | `clsAffiliatedPolicyCollection` |
| **Criteria property** | `RetrieveSQL` |
| **Lifecycle method** | `BeforeRetrieve` / `AfterRetrieve` |

## Parameters

| Parameter | Direction | Type | Max length | Description |
| --- | --- | --- | --- | --- |
| `in_policy_num` | Input | Decimal | N/A | Policy number to look up affiliations for. |
| `in_affiliate_type` | Input | String | 25 | Affiliate-type filter code. |
| `in_include_affil_totals` | Input | String (literal `"TRUE"`/`"FALSE"`) | N/A | Whether to include affiliate totals in the result.* |
| `recordset` | Output (Cursor) | REF CURSOR | N/A | Result set of affiliated policies; filtered in-memory by agent/agency in `AfterRetrieve`. |

## Tables

| Table | Access | Columns used |
| --- | --- | --- |
| *(not directly visible — encapsulated in procedure body)* | SELECT | N/A |

## Sample SQL

```sql
BEGIN
  pk72846_view_policy.getpolicyaffiliatelist(
    in_policy_num            => :in_policy_num,
    in_affiliate_type        => :in_affiliate_type,
    in_include_affil_totals  => :in_include_affil_totals,
    recordset                => :recordset
  );
END;
```

*`in_include_affil_totals` is passed the string literal `"TRUE"` or `"FALSE"` rather than a boolean
type.*

## Business rules
- [BR-VP-013: Affiliated-policy agent/agency filter](../business-rules.md#br-vp-013-affiliated-policy-agent-agency-filter)

> **Note:** Statements marked with `*` were inferred from code structure, naming
> conventions, or contextual evidence where direct confirmation was not available
> in source artifacts. Statements marked with `**` could not be confirmed; treat
> as unknown until verified.

## Sources
- `SAIF.Business.View.Policy\clsAffiliatedPolicyCollection.vb`